Hash Manager
 

- This Add-on Like Its name use to manage your hash Table

- It's  quite simple  and easy to use  but after many improvements  and remove the context help (Replaced by maximize button) , Now  I must write  a document for it so you  can completely  control it , and use it for your purpose, This document contains:

+Explain :

- Tree view and List view

- Tab :  Hash Table (first tab)  Search (second tab)   Load/Save (third tab)

- Reduce Refresh Time

+Guide:

- Add ,delete and Rename an Item

- Sort list and options

- mass modify

- Custom filter...

1. Options and Items :

     Hash  or  Table   is  refer to Hash Table

    

   •  Tree View and List View

   When I  started to write this add-on , I had used  Tree view  to display your Hash Information

    * Some advantages:

     - You can view and process all your Hashes  at one time

     - Rename an item quite easily

     - you are not confuse much  to see What is Item or Data

   *  The  disadvantages are :

     - It take a lot  of times to load  All Hashes

     - Time to Process with Tree view is large and It couldn't accept with  large Tables

     - It's not actually good for view data of a Table

   So I decided to use List view to display your Hash, when Process: It is limited  for only one table (not a problem) ,faster and you can preview your data better

   because  use both Tree and List view, so I have Added 2 options ,and now you can easily choose once or both of them (or  neither) :  - Auto Refresh Treeview and Auto Refresh Listview. They are not completely  disable Treeview or Listview,  but  still use them with some suitable cases and they're value in these cases.

   • First Tab (Hash Table):
     • "Add Item" Button:  The button is made to update the item data or add a new one. When the data of the item is edited the button is enabled, And when you press , it will add the item by the command: /hadd -m Selected-Table Selected-Item Data. This command can be easily changed by  button "!!"  near icon 'eyes' , with  "!!" you can change every part of  this command
        
     • "Del Item" Button : is a button that deletes a selected item from the list view or tree view (or you can edit an item in edit box). It's disabled when the item is not available
        And once an item is deleted there is no way to recover it, if it wasn't saved.
        
     • "Rename Item" Button: The button changes the selected item name into what you added. The button is disabled on 2 cases, If the new name already exists or the edit box is empty.
        
   • Second Tab (search)

      This Tab use to control search Operations, Fill an expression/text/options and push "Search" button , Script will display the result into bellow list.
      

     • Search List:
        This List holds the results of the search you did, In case it was empty that means that there's no matched. All columns of that list are :
       + M: (Matches) The first part which is M holds the matches typed.
       - if the match was in the ITEM name then M will hold "I"
       - if the matching was in DATA M will hold "D"
       - In case of both matches, It will hold: ID.
       + TABLES: this part holds the matching tables name where text was matched it.
       + Item: The matched Item\Data Item name.
       + Data: The matched Item\Data Data .
        
     • "Search" Button : This button starts the scanning with the string text added in the edit box.
        
     • "Clipboard" Button: copy the selected line in the list box into Clipboard as the following: TABLE ITEM=DATA
        
     • Options:
       +Regex:
       Check This if you want to use a regular expression (fill in edit box)
       - when enable this check, you have to know what Regular expression is
       + Isin & Iswm:  This check sets the search type, If it's ISWM or ISIN. Where ISWM allows wildcards (* / ?) in the searching. While ISIN don't.
       + for All hashes: Check This for search All hashes or Only One
       + for Only Item: Search for only Items
        
   • Third Tab:
     • The list in this tab, returns the files names/directories that has been saved. As well it holds its size in bytes, and the number of tables\items in it. To Load Hash Tables you just need to double click in a line
     • "Auto Save/Load Tables:" Check:  Its main function is to remember your tables. When it's checked, the script on exit will saves all tables into temp file.
        And when you reopen your mIRC the script will auto load them, and deletes the files. By this option your hash tables will always be the same if you never changed them, and like the info wont be lost when close the mIRC.
     •  "When Load Clear hash Table" : IF it's checked , When you load a new file, The script will delete the old ones and keep the new ones only.
        IF it's not, The script will add the old with the new, If the items are in the same table, then the old items will be replaced with the new ones, and the new tables will be added with all the others.
        
   • Reduce Refresh Time:

     What actually this check do ? , I should say a little  , because the list has 3 columns , #3 column is  Nth of  Items in hash Table , Nth Items are changed  after add or delete (rename)  an item so I must refresh list after these actions , to Prevent Refresh frequently like that ,  I suggest you  check  this option. but  Nth of  Items is not accuracy if you are not refresh List , That's your choice (Speed or Accuracy)

      

2. Actions:

   • Add Item/Data

       - You can use many ways to add  item/data in your hash Table :

        *  right click on Treeview  or List view  and choose "Add Item"

        * double click  an Item in List view  

        *  fill Item and data  in edit boxes  bellow your List view  and push "Add" Button

        - Add an Item/data operation  is include modify action :  If  An Item has , It will be modified to a new value   (should I  add some options here ? )

   •  Delete Items: Like Add Item , but you can delete many items  at one time by select them in List view  and right click  to delete all selected (right click will  call a popup so you will choose Add or Delete )
      
   • Rename Item: This can be done  by  single click in an Item name or you can  choose an item and  fill  your new item name in edit box (bellow List View) , click button "Rename To" , to rename it

    

   • Sort :
     •  Click on header to check and use this feature  (for each headers you can easily choose one method to sort list  follow your desire:  Methods  are  Ascending (sort increasing) , Descending (sort decreasing)  and  Data is Numeric or string (set of characters)
     • If You are not use sort List, you will save a lot of time
     • When Added an Item/data  , your Item/data will Append at last  of List view , and I don't Sort it again because It will take a lot of time (not valuable to do that)
     • You can save your time , by check -  Sort when refresh  ,  what it means , It's only sort when you push button "Refresh list" , This option effects only when you've already checked a column for sorting .
     • You can manual sort a list , by click on the first line of  Popup ( Sort........)
     • for Search Result , It's always use manual method
       • The first : check  your options and click on header 1 (field M) to sort your result
       • second: click on others header  and  choose the first Popup line  to sort your result
          
   • Mass Modify: first  select all Items/data you want to replace, and click button Mass modify , It's similar a Tool to replace text , fill your options , and then click replace  to change your selected Items/data , More explanation can be found in  "Find & Replace" dialog  (click $alias(@D))
     Note: You can use blank Replace text to delete some subtext in  original text
   • Custom Filter:

     This option uses to filter your data/item  , when use wildcard , all most is well done ,  but  when use Regex , It 's wrong  because  It filter both item and data with same Regex (the priority of Regex expression to process in this case is : Item and then Data , you just need to fill #1 or #2  edit box)

      the solution so It can use Regex for only Item or Data is :

     Item/Data/number separate by $chr(9)  when you want filter only data you can specify an Regex like this:

     .* $+ $chr(9) $+ [Data Regex] $+ $chr(9) .*

     or Item : [ Item Regex ] $+ $chr(9) .* $+ $chr(9) .*

     It's actually my mistake , and laziness ,I fell  the code is too long , so I don't want to continue process with Regex , if you want use Regex to filter only data or Item , just construct  an expression like above

     once day  when I feel It's actually need  , I will change my code but now do it yourself or  you could rewrite this Add-on follow your ideas , sorry for this inconvenience (but you have  more speed when process with  Hash Table by this way)

      

      future expansion  ?

     + This is your work (possible)

     - you can change custom filter dialog to a new form

     - you  can use  another way to process with Regex

     - and more  depends your ideas

     + and  my work only begins when:

     -  I  find a way to  auto construct  a Regex for you , I will continue improve this feature

     -  I have some new ideas !

     -  my feeling is good